ci(release): version packages - #463
Merged
Merged
Conversation
the-faceter
Bot
force-pushed
the
changeset-release/main
branch
7 times, most recently
from
July 24, 2026 05:02
43a1d43 to
4295ad6
Compare
the-faceter
Bot
force-pushed
the
changeset-release/main
branch
from
July 24, 2026 05:03
4295ad6 to
95e8cc6
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR was auto-generated by the release workflow. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.
Releases
@agent-facets/adapter@0.28.0
Minor Changes
d20cdaeThanks @eXamadeus! - BREAKING (pre-1.0 minor): the adapter asset contract is now tagged request/result unions instead of positional parameters, and the adapter API identifier advances from0.0to0.1.installAsset,readAsset, anddeleteAsseteach take a single request object tagged byassetTypeand return a discriminated result — expected failures (not-found,invalid-companion-path,unsupported-scope,not-implemented,io-failed) are structured values, never thrown errors. Skill requests carry a companion byte map plus the caller-verified owned companion path set for atomic multi-file skill bundles; agent and command requests structurally cannot carry companions.defineAdapterstubs for omitted methods now returnnot-implementedfailures instead of throwing.The SDK's canonical
ADAPTER_API_VERSIONis now0.1, identifying this tagged contract;defineAdapter()stamps it and first-party packages publish"facetAdapterApiVersion": "0.1".0.0named the earlier positional contract: a CLI that supports only0.1classifies a0.0adapter as well-formed but unsupported and fails closed (before any contract method or project write) with reinstall guidance. There is no positional/tagged compatibility bridge — an adapter built against0.0must be rebuilt against a0.1SDK release and reinstalled.New SDK helpers:
installSkillBundle/readSkillBundle/deleteSkillBundle(staged all-or-nothing bundle replacement with rollback, ownership-set-based deletion, and empty-directory pruning),installSingleFileAsset/readSingleFileAsset/deleteSingleFileAsset(result-shaped single-file operations), andvalidateContainedRelativePath(pre-filesystem containment validation applied to every supplied companion path).Every adapter implementing the previous positional contract must migrate. The first-party claude-code, opencode, and codex adapters are migrated in their matching minor releases; codex delete operations now prune emptied directories consistently with the other adapters.
Release ordering: this SDK release and the three first-party adapter releases publish
0.1to npm before anyagent-facetsCLI release requires0.1. Until that CLI ships, existing0.0CLIs keep selecting the highest compatible0.0adapter release, so this changeset intentionally carries noagent-facetsbump — the CLI change that makes0.1the supported set lands in a later release cycle gated on all three first-party adapters having publishedfacetAdapterApiVersion: 0.1.@agent-facets/adapter-claude-code@0.9.0
Minor Changes
d20cdaeThanks @eXamadeus! - BREAKING (pre-1.0 minor): the adapter asset contract is now tagged request/result unions instead of positional parameters, and the adapter API identifier advances from0.0to0.1.installAsset,readAsset, anddeleteAsseteach take a single request object tagged byassetTypeand return a discriminated result — expected failures (not-found,invalid-companion-path,unsupported-scope,not-implemented,io-failed) are structured values, never thrown errors. Skill requests carry a companion byte map plus the caller-verified owned companion path set for atomic multi-file skill bundles; agent and command requests structurally cannot carry companions.defineAdapterstubs for omitted methods now returnnot-implementedfailures instead of throwing.The SDK's canonical
ADAPTER_API_VERSIONis now0.1, identifying this tagged contract;defineAdapter()stamps it and first-party packages publish"facetAdapterApiVersion": "0.1".0.0named the earlier positional contract: a CLI that supports only0.1classifies a0.0adapter as well-formed but unsupported and fails closed (before any contract method or project write) with reinstall guidance. There is no positional/tagged compatibility bridge — an adapter built against0.0must be rebuilt against a0.1SDK release and reinstalled.New SDK helpers:
installSkillBundle/readSkillBundle/deleteSkillBundle(staged all-or-nothing bundle replacement with rollback, ownership-set-based deletion, and empty-directory pruning),installSingleFileAsset/readSingleFileAsset/deleteSingleFileAsset(result-shaped single-file operations), andvalidateContainedRelativePath(pre-filesystem containment validation applied to every supplied companion path).Every adapter implementing the previous positional contract must migrate. The first-party claude-code, opencode, and codex adapters are migrated in their matching minor releases; codex delete operations now prune emptied directories consistently with the other adapters.
Release ordering: this SDK release and the three first-party adapter releases publish
0.1to npm before anyagent-facetsCLI release requires0.1. Until that CLI ships, existing0.0CLIs keep selecting the highest compatible0.0adapter release, so this changeset intentionally carries noagent-facetsbump — the CLI change that makes0.1the supported set lands in a later release cycle gated on all three first-party adapters having publishedfacetAdapterApiVersion: 0.1.@agent-facets/adapter-codex@0.7.0
Minor Changes
d20cdaeThanks @eXamadeus! - BREAKING (pre-1.0 minor): the adapter asset contract is now tagged request/result unions instead of positional parameters, and the adapter API identifier advances from0.0to0.1.installAsset,readAsset, anddeleteAsseteach take a single request object tagged byassetTypeand return a discriminated result — expected failures (not-found,invalid-companion-path,unsupported-scope,not-implemented,io-failed) are structured values, never thrown errors. Skill requests carry a companion byte map plus the caller-verified owned companion path set for atomic multi-file skill bundles; agent and command requests structurally cannot carry companions.defineAdapterstubs for omitted methods now returnnot-implementedfailures instead of throwing.The SDK's canonical
ADAPTER_API_VERSIONis now0.1, identifying this tagged contract;defineAdapter()stamps it and first-party packages publish"facetAdapterApiVersion": "0.1".0.0named the earlier positional contract: a CLI that supports only0.1classifies a0.0adapter as well-formed but unsupported and fails closed (before any contract method or project write) with reinstall guidance. There is no positional/tagged compatibility bridge — an adapter built against0.0must be rebuilt against a0.1SDK release and reinstalled.New SDK helpers:
installSkillBundle/readSkillBundle/deleteSkillBundle(staged all-or-nothing bundle replacement with rollback, ownership-set-based deletion, and empty-directory pruning),installSingleFileAsset/readSingleFileAsset/deleteSingleFileAsset(result-shaped single-file operations), andvalidateContainedRelativePath(pre-filesystem containment validation applied to every supplied companion path).Every adapter implementing the previous positional contract must migrate. The first-party claude-code, opencode, and codex adapters are migrated in their matching minor releases; codex delete operations now prune emptied directories consistently with the other adapters.
Release ordering: this SDK release and the three first-party adapter releases publish
0.1to npm before anyagent-facetsCLI release requires0.1. Until that CLI ships, existing0.0CLIs keep selecting the highest compatible0.0adapter release, so this changeset intentionally carries noagent-facetsbump — the CLI change that makes0.1the supported set lands in a later release cycle gated on all three first-party adapters having publishedfacetAdapterApiVersion: 0.1.@agent-facets/adapter-opencode@0.10.0
Minor Changes
d20cdaeThanks @eXamadeus! - BREAKING (pre-1.0 minor): the adapter asset contract is now tagged request/result unions instead of positional parameters, and the adapter API identifier advances from0.0to0.1.installAsset,readAsset, anddeleteAsseteach take a single request object tagged byassetTypeand return a discriminated result — expected failures (not-found,invalid-companion-path,unsupported-scope,not-implemented,io-failed) are structured values, never thrown errors. Skill requests carry a companion byte map plus the caller-verified owned companion path set for atomic multi-file skill bundles; agent and command requests structurally cannot carry companions.defineAdapterstubs for omitted methods now returnnot-implementedfailures instead of throwing.The SDK's canonical
ADAPTER_API_VERSIONis now0.1, identifying this tagged contract;defineAdapter()stamps it and first-party packages publish"facetAdapterApiVersion": "0.1".0.0named the earlier positional contract: a CLI that supports only0.1classifies a0.0adapter as well-formed but unsupported and fails closed (before any contract method or project write) with reinstall guidance. There is no positional/tagged compatibility bridge — an adapter built against0.0must be rebuilt against a0.1SDK release and reinstalled.New SDK helpers:
installSkillBundle/readSkillBundle/deleteSkillBundle(staged all-or-nothing bundle replacement with rollback, ownership-set-based deletion, and empty-directory pruning),installSingleFileAsset/readSingleFileAsset/deleteSingleFileAsset(result-shaped single-file operations), andvalidateContainedRelativePath(pre-filesystem containment validation applied to every supplied companion path).Every adapter implementing the previous positional contract must migrate. The first-party claude-code, opencode, and codex adapters are migrated in their matching minor releases; codex delete operations now prune emptied directories consistently with the other adapters.
Release ordering: this SDK release and the three first-party adapter releases publish
0.1to npm before anyagent-facetsCLI release requires0.1. Until that CLI ships, existing0.0CLIs keep selecting the highest compatible0.0adapter release, so this changeset intentionally carries noagent-facetsbump — the CLI change that makes0.1the supported set lands in a later release cycle gated on all three first-party adapters having publishedfacetAdapterApiVersion: 0.1.Note
Medium Risk
Publishes a breaking pre-1.0 adapter contract (
0.1) that forces third-party adapter rebuilds; lockfile schema change may affect tooling that reads facets.lock.Overview
Automated release PR that bumps
@agent-facets/adapterto 0.28.0 and the claude-code, opencode, and codex adapter packages to matching minors, with changelog entries for the adapter API0.0→0.1breaking change from #438. The consumed changeset is removed andbun.lockversion pins are updated accordingly; there is noagent-facetsCLI bump in this cycle.facets.lockmoves tolockfileVersion0.2, adding per-assetfilesentries (relative path +sha256integrity) for every locked facet asset instead of name-only asset records.Reviewed by Cursor Bugbot for commit 95e8cc6. Bugbot is set up for automated code reviews on this repo. Configure here.